release: v3.1.0 — puente desde design.md, regla sin costo ni licencias, .env.example legible - #22

Summary

Release 3.1.0. El tag v3.1.0 se crea sobre master después del merge.

• Del diseño al código: /project-context <ruta>/design.md. Si el sistema se diseñó con system-design-kit, project-context traslada el diseño sin reescribirlo:

  • visión y "fuera de alcance (v1)";
  • atributos de calidad con sus umbrales;
  • modelo de dominio y contratos;
  • arquitectura con las fallas previstas y sus tests de regresión;
  • supuestos pendientes;
  • un ADR por decisión, con la plantilla de la skill adr.

  Anota el diseño de origen y su fecha para reimportar solo lo que cambie. Mapeo en skills/project-context/desde-design.md.

• Regla §6.1.7: nada de pago, con API key o licencia propietaria o modificada. Está en la baseline y en la checklist del hook pre-bash. Se retiran las recomendaciones que no cumplían, con su motivo en discarded:

  • security-guidance: llamadas pagadas a Opus.
  • claude-security: licencia propietaria.
  • php-lsp: depende de Intelephense, propietario.
  • react-doctor: MIT modificada. Lo sustituyen eslint-plugin-react-hooks y los profilers de DevTools.

• Fix: el agente no podía leer .env.example porque Read(./.env.*) también lo bloqueaba. Ahora hay denies explícitos más un hook pre-read que bloquea cualquier .env*/.envrc salvo los ejemplos. --update retira el patrón viejo.

• Fix: la baseline indicaba /docs + !/docs/adr, que git no reincluye; ahora /docs/* + !/docs/adr/.

Test plan

• npm run validate (50) y npm test (112/112; 12 nuevos: pre-read, retiro del permiso viejo y regla §6.1.7 en el hook).
• Smoke de los 13 stacks.
• Sesión real de /project-context <design.md> en un proyecto vacío con un diseño completo: 3 ADRs (Aceptado), CLAUDE.project.md de 139 líneas que separa lo trasladado de lo inferido, 9 pendientes (uno, un hueco del diseño: SSRF en long_url), y design.md intacto.
• Sesión real tras --update: lee .env.example y el .env real queda bloqueado.
• Tras el merge: tag v3.1.0 y smoke con npx.